Customize browse text of the custom file input with HTML (#27651)

MartijnCuppens · XhmikosR · commit 696c4078d131 · 2018-11-13T08:30:17.000+02:00
diff --git a/scss/_custom-forms.scss b/scss/_custom-forms.scss
@@ -276,6 +276,10 @@
       content: $value;
     }
   }
+
+  ~ .custom-file-label[data-browse]::after {
+    content: attr(data-browse);
+  }
 }
 
 .custom-file-label {
diff --git a/site/docs/4.1/components/forms.md b/site/docs/4.1/components/forms.md
@@ -1287,7 +1287,7 @@ The file input is the most gnarly of the bunch and requires additional JavaScrip
 
 We hide the default file `<input>` via `opacity` and instead style the `<label>`. The button is generated and positioned with `::after`. Lastly, we declare a `width` and `height` on the `<input>` for proper spacing for surrounding content.
 
-#### Translating or customizing the strings
+#### Translating or customizing the strings with SCSS
 
 The [`:lang()` pseudo-class](https://developer.mozilla.org/en-US/docs/Web/CSS/:lang) is used to allow for translation of the "Browse" text into other languages. Override or add entries to the `$custom-file-text` Sass variable with the relevant [language tag](https://en.wikipedia.org/wiki/IETF_language_tag) and localized strings. The English strings can be customized the same way. For example, here's how one might add a Spanish translation (Spanish's language code is `es`):
 
@@ -1309,3 +1309,15 @@ Here's `lang(es)` in action on the custom file input for a Spanish translation:
 {% include example.html content=example %}
 
 You'll need to set the language of your document (or subtree thereof) correctly in order for the correct text to be shown. This can be done using [the `lang` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang) on the `<html>` element or the [`Content-Language` HTTP header](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.12), among other methods.
+
+#### Translating or customizing the strings with HTML
+
+Bootstrap also provides a way to translate the "Browse" text in HTML with the `data-browse` attribute which can be added to the custom input label (example in Dutch):
+
+{% capture example %}
+<div class="custom-file">
+  <input type="file" class="custom-file-input" id="customFileLangHTML">
+  <label class="custom-file-label" for="customFileLangHTML" data-browse="Bestand kiezen">Voeg je document toe</label>
+</div>
+{% endcapture %}
+{% include example.html content=example %}

Original file line number	Diff line number	Diff line change
`@@ -276,6 +276,10 @@`
`276`	`276`	`content: $value;`
`277`	`277`	`}`
`278`	`278`	`}`
	`279`	`+`
	`280`	`+ ~ .custom-file-label[data-browse]::after {`
	`281`	`+ content: attr(data-browse);`
	`282`	`+ }`
`279`	`283`	`}`
`280`	`284`
`281`	`285`	`.custom-file-label {`