diff --git a/zh-cn/application-dev/internationalization/i18n-guidelines.md b/zh-cn/application-dev/internationalization/i18n-guidelines.md index 4b29113637d3733fc70f4c8e18ad77963554bfac..b640c84ec48b7daeaf67727aa57bb73d980ac778 100644 --- a/zh-cn/application-dev/internationalization/i18n-guidelines.md +++ b/zh-cn/application-dev/internationalization/i18n-guidelines.md @@ -22,7 +22,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ### 开发步骤 -1. 获取系统语言 +1. 获取系统语言。
调用getSystemLanguage方法获取当前系统设置的语言(i18n为导入的模块)。 @@ -30,21 +30,21 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var language = i18n.getSystemLanguage(); ``` -2. 获取系统区域 - 调用getSystemRegion方法获取当前系统设置的区域 +2. 获取系统区域。
+ 调用getSystemRegion方法获取当前系统设置的区域。 ``` var region = i18n.getSystemRegion(); ``` -3. 获取系统Locale - 调用getSystemLocale方法获取当前系统设置的Locale +3. 获取系统Locale。
+ 调用getSystemLocale方法获取当前系统设置的Locale。 ``` var locale = i18n.getSystemLocale(); ``` -4. 判断Locale的语言是否为RTL语言 +4. 判断Locale的语言是否为RTL语言。
调用isRTL方法获取Locale的语言是否为从右到左语言。 @@ -52,15 +52,15 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var rtl = i18n.isRTL("zh-CN"); ``` -5. 判断当前系统时间是否采用24小时制 - 调用is24HourClock方法来判断当前系统的时间是否采用24小时制。 +5. 判断当前系统时间是否采用24小时制。
+ 调用is24HourClock方法来判断当前系统的时间是否采用24小时制。 ``` var hourClock = i18n.is24HourClock(); ``` -6. 获取语言的本地化表示 - 调用getDisplayLanguage方法获取某一语言的本地化表示。其中,language表示待本地化显示的语言,locale表示本地化的Locale,sentenceCase结果是否需要首字母大写。 +6. 获取语言的本地化表示。
+ 调用getDisplayLanguage方法获取某一语言的本地化表示。其中,language表示待本地化显示的语言,locale表示本地化的Locale,sentenceCase结果是否需要首字母大写。 ``` var language = "en"; @@ -69,8 +69,8 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var localizedLanguage = i18n.getDisplayLanguage(language, locale, sentenceCase); ``` -7. 获取国家的本地化表示 - 调用getDisplayCountry方法获取某一国家的本地化表示。其中,country表示待本地化显示的国家,locale表示本地化的Locale,sentenceCase结果是否需要首字母大写。 +7. 获取国家的本地化表示。
+ 调用getDisplayCountry方法获取某一国家的本地化表示。其中,country表示待本地化显示的国家,locale表示本地化的Locale,sentenceCase结果是否需要首字母大写。 ``` var country = "US"; @@ -105,7 +105,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ### 开发步骤 -1. 实例化日历对象 +1. 实例化日历对象。
调用getCalendar方法获取指定locale和type的时区对象(i18n为导入的模块)。其中,type表示合法的日历类型,目前合法的日历类型包括:"buddhist", "chinese", "coptic", "ethiopic", "hebrew", "gregory", "indian", "islamic_civil", "islamic_tbla", "islamic_umalqura", "japanese", "persian"。当type没有给出时,采用区域默认的日历类型。 @@ -113,8 +113,8 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var calendar = i18n.getCalendar("zh-CN", "gregory); ``` -2. 设置日历对象的时间 - 调用setTime方法设置日历对象的时间。setTime方法接收两种类型的参数。一种是传入一个Date对象,另一种是传入一个数值表示从1970.1.1 00:00:00 GMT逝去的毫秒数。 +2. 设置日历对象的时间。
+ 调用setTime方法设置日历对象的时间。setTime方法接收两种类型的参数。一种是传入一个Date对象,另一种是传入一个数值表示从1970.1.1 00:00:00 GMT逝去的毫秒数。 ``` var date1 = new Date(); @@ -123,8 +123,8 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 calendar.setTime(date2); ``` -3. 设置日历对象的年、月、日、时、分、秒 - 调用set方法设置日历对象的年、月、日、时、分、秒。 +3. 设置日历对象的年、月、日、时、分、秒。
+ 调用set方法设置日历对象的年、月、日、时、分、秒。 ``` calendar.set(2021, 12, 21, 6, 0, 0) @@ -139,7 +139,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var timezone = calendar.getTimeZone(); ``` -5. 设置、获取日历对象的一周起始日 +5. 设置、获取日历对象的一周起始日。
调用setFirstDayOfWeek方法和getFirstDayOfWeek方法设置、获取日历对象的一周起始日。其中,setFirstDayOfWeek需要传入一个数值表示一周的起始日,1代表周日,7代表周六。 @@ -148,15 +148,15 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var firstDayOfWeek = calendar.getFirstDayOfWeek(); ``` -6. 设置、获取日历对象第一周的最小天数 - 调用setMinimalDaysInFirstWeek方法和getMinimalDaysInFirstWeek方法来设置、获取日历对象第一周的最小天数。 +6. 设置、获取日历对象第一周的最小天数。
+ 调用setMinimalDaysInFirstWeek方法和getMinimalDaysInFirstWeek方法来设置、获取日历对象第一周的最小天数。 ``` calendar.setMinimalDaysInFirstWeek(3); var minimalDaysInFirstWeek = calendar.getMinimalDaysInFirstWeek(); ``` -7. 获取日历对象的本地化显示 +7. 获取日历对象的本地化显示。
调用getDisplayName来获取日历对象的本地化显示。 @@ -164,7 +164,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var localizedName = calendar.getDisplayName("zh-CN"); ``` -8. 判断某一个日期是否为周末 +8. 判断某一个日期是否为周末。
调用isWeekend方法来判断输入的Date是否为周末。 @@ -190,7 +190,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ### 开发步骤 -1. 实例化电话号码格式化对象 +1. 实例化电话号码格式化对象。
调用PhoneNumberFormat的构造函数来实例化电话号码格式化对象,需要传入电话号码的国家代码及格式化选项。其中,格式化选项是可选的,包括style选项,该选项的取值包括:"E164", "INTERNATIONAL", "NATIONAL", "RFC3966"。 @@ -198,15 +198,15 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var phoneNumberFormat = new i18n.PhoneNubmerFormat("CN", {type: "E164"}); ``` -2. 判断电话号码格式是否正确 - 调用isValidNumber方法来判断输入的电话号码的格式是否正确。 +2. 判断电话号码格式是否正确。
+ 调用isValidNumber方法来判断输入的电话号码的格式是否正确。 ``` var validNumber = phoneNumberFormat.isValidNumber("15812341234"); ``` -3. 电话号码格式化 - 调用电话号码格式化对象的format方法来对输入的电话号码进行格式化。 +3. 电话号码格式化。
+ 调用电话号码格式化对象的format方法来对输入的电话号码进行格式化。 ``` var formattedNumber = phoneNumberFormat.format("15812341234"); @@ -227,7 +227,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ### 开发步骤 -1. 度量衡单位转换 +1. 度量衡单位转换。
调用[unitConvert](../reference/apis/js-apis-intl.md)方法实现度量衡单位转换,并进行格式化显示的功能。 @@ -258,7 +258,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ### 开发步骤 -1. 实例化字母表索引对象 +1. 实例化字母表索引对象。
调用getInstance方法来实例化特定locale对应的字母表索引对象。当locale参数为空时,实例化系统默认Locale的字母表索引对象。 @@ -266,22 +266,22 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var indexUtil = getInstance("zh-CN"); ``` -2. 获取索引列表 - 调用getIndexList方法来获取当前Locale对应的字母表索引列表。 +2. 获取索引列表。
+ 调用getIndexList方法来获取当前Locale对应的字母表索引列表。 ``` var indexList = indexUtil.getIndexList(); ``` -3. 增加新的索引 - 调用addLocale方法,将新的Locale对应的字母表索引添加到当前字母表索引列表中。 +3. 增加新的索引。
+ 调用addLocale方法,将新的Locale对应的字母表索引添加到当前字母表索引列表中。 ``` indexUtil.addLocale("ar") ``` -4. 获取字符串对应的索引 - 调用getIndex方法来获取某一字符串对应的字母表索引。 +4. 获取字符串对应的索引。
+ 调用getIndex方法来获取某一字符串对应的字母表索引。 ``` var text = "access index"; @@ -312,7 +312,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ### 开发步骤 -1. 实例化断行对象 +1. 实例化断行对象。
调用getLineInstance方法来实例化断行对象。 @@ -321,7 +321,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var breakIterator = i18n.getLineInstance(locale); ``` -2. 设置、访问要断行处理的文本 +2. 设置、访问要断行处理的文本。
调用setLineBreakText方法和getLineBreakText方法来设置、访问要断行处理的文本。 @@ -331,7 +331,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var breakText = breakIterator.getLineBreakText(); ``` -3. 获取断行对象当前的位置 +3. 获取断行对象当前的位置。
调用current方法来获取断行对象在当前处理文本中的位置。 @@ -339,7 +339,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var pos = breakIterator.current(); ``` -4. 设置断行对象的位置 +4. 设置断行对象的位置。
系统提供了很多接口可以用于调整断行对象在处理文本中的位置,包括first, last, next, previous, following。 @@ -355,7 +355,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 var followingPos = breakIterator.following(10); ``` -5. 判断某个位置是否为分割点 +5. 判断某个位置是否为分割点。
调用isBoundary方法来判断一个方法是否为分割点;如果该位置是分割点,则返回true,并且将断行对象移动到该位置;如果该位置不是分割点,则返回false,并且将断行对象移动到该位置后的一个分割点。