Version: Unity 6.7 Beta (6000.7)
LanguageEnglish
  • C#

ILocalizedStringList

interface in Unity.Localization

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Interface for resolving a localized list of strings.

Implementations resolve one or more table entries into an ordered list, for example the options of a dropdown. Subscribe to ILocalizedStringList.ListChanged to receive the values and every later change, including locale switches, or resolve on demand with ILocalizedStringList.GetLocalizedList and ILocalizedStringList.GetLocalizedListAsync. The built-in implementations are LocalizedStringList, which splits one entry on a separator, and LocalizedStringGroup, which combines several entries.

Additional resources: LocalizedStringList, LocalizedStringGroup, LocalizeStringListEvent

Resolve a list of options and fill a dropdown.

using System.Collections.Generic;
using Unity.Localization;
using UnityEngine;

namespace Unity.Localization.Samples { public class LocalizedStringListExample { public async Awaitable Load() { // The entry's value holds every option, for example "Low,Medium,High". var options = new LocalizedStringList { Separator = "," }; options.SetReference("My Strings", "QUALITY OPTIONS"); List<string> values = await options.GetLocalizedListAsync(); Debug.Log(values.Count); } } }

Public Methods

Method Description
GetLocalizedList Resolves the localized values without waiting.
GetLocalizedListAsync Resolves the localized values, loading tables as needed.

Events

Event Description
ListChanged Raised with the localized values when the list first resolves and again whenever a value changes.