---
title: "localization_form"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/tag/localization-form'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/tag/localization-form.md'
---

# localization_form


    生成用于国家或地区、语言切换的 `<form>` 表单。

    该表单可用于以下两种场景：
- 国家或地区选择器
- 语言选择器



```sline
{{#localization_form}} custom code {{/localization_form}}
```







    
## 可选参数

        
             `return_to` `string`：表单提交后的重定向 URL，默认为当前页面。
        
    



    
## 例子

        
            ### 国家或地区选择器

            表单提交字段为 `country_code`，值为对应的国家或地区码。可通过遍历 `localization.available_countries` 列表，获取每个国家或地区对象的 `iso_code` 字段。

            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["localization"] 
}>
```sline
{{#localization_form enctype="multipart/form-data" accept-charset="UTF-8"}}
  <select name="country_code" onchange="this.form.submit();">
    {{#for country in localization.available_countries}}
      <option value="{{country.iso_code}}" {{#if localization.country.iso_code == country.iso_code}}selected{{/if}}>
        {{country.name}}（{{country.currency.iso_code}}
        {{country.currency.symbol}}）
      </option>
    {{/for}}
  </select>
{{/localization_form}}
```
</SlineExample>
            
        
            ### 语言选择器

            表单提交字段为 `locale_code`，值为对应的语言编码。可通过遍历 `localization.available_languages` 列表，获取每个语言对象的 `iso_code` 字段。

            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["localization"] 
}>
```sline
{{#localization_form enctype="multipart/form-data" accept-charset="UTF-8"}}
  <select name="locale_code" onchange="this.form.submit();">
    {{#for language in localization.available_languages}}
      <option value="{{language.iso_code}}" {{#if localization.language.endonym_name == language.endonym_name}}selected{{/if}}>
        {{language.endonym_name}}
      </option>
    {{/for}}
  </select>
{{/localization_form}}
```
</SlineExample>
            
        
            ### 添加 HTML 属性

            传入标准的 [HTML form 属性](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/form#%E5%B1%9E%E6%80%A7)，例如：`name`、`accept-charset` 等。

            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    [""] 
}>
```sline
{{#localization_form id="localization-form" enctype="multipart/form-data" accept-charset="UTF-8"}}
custom code
{{/localization_form}}
```
</SlineExample>