Update XMB placeholders(<ph>) to include the original value on top of an
example. Placeholders can by definition have one example(<ex>) tag and a
text node. The text node is used by TC as the "original" value from the
placeholder, while the example should represent a dummy value.
For example: <ph name="PET"><ex>Gopher</ex>{{ petName }}</ph>.
This change makes sure that we have the original text, but it *DOES NOT*
make sure that the example is correct. The example has the same wrong
behavior of showing the interpolation text rather than a useful
example.
No breaking changes, but tools that depend on the previous behavior and
don't consider the full XMB definition may fail to parse the XMB.
Fixes b/72565847
PR Close #25079
		
	
			
		
			
				
	
	
		
			87 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			87 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
| /**
 | |
|  * @license
 | |
|  * Copyright Google Inc. All Rights Reserved.
 | |
|  *
 | |
|  * Use of this source code is governed by an MIT-style license that can be
 | |
|  * found in the LICENSE file at https://angular.io/license
 | |
|  */
 | |
| 
 | |
| import {MessageBundle} from '@angular/compiler/src/i18n/message_bundle';
 | |
| import {Xmb} from '@angular/compiler/src/i18n/serializers/xmb';
 | |
| import {HtmlParser} from '@angular/compiler/src/ml_parser/html_parser';
 | |
| import {DEFAULT_INTERPOLATION_CONFIG} from '@angular/compiler/src/ml_parser/interpolation_config';
 | |
| 
 | |
| {
 | |
|   describe('XMB serializer', () => {
 | |
|     const HTML = `
 | |
| <p>not translatable</p>
 | |
| <p i18n>translatable element <b>with placeholders</b> {{ interpolation}}</p>
 | |
| <!-- i18n -->{ count, plural, =0 {<p>test</p>}}<!-- /i18n -->
 | |
| <p i18n="m|d">foo</p>
 | |
| <p i18n="m|d@@i">foo</p>
 | |
| <p i18n="@@bar">foo</p>
 | |
| <p i18n="@@baz">{ count, plural, =0 { { sex, select, other {<p>deeply nested</p>}} }}</p>
 | |
| <p i18n>Test: { count, plural, =0 { { sex, select, other {<p>deeply nested</p>}} } =other {a lot}}</p>
 | |
| <p i18n>multi
 | |
| lines</p>`;
 | |
| 
 | |
|     const XMB = `<?xml version="1.0" encoding="UTF-8" ?>
 | |
| <!DOCTYPE messagebundle [
 | |
| <!ELEMENT messagebundle (msg)*>
 | |
| <!ATTLIST messagebundle class CDATA #IMPLIED>
 | |
| 
 | |
| <!ELEMENT msg (#PCDATA|ph|source)*>
 | |
| <!ATTLIST msg id CDATA #IMPLIED>
 | |
| <!ATTLIST msg seq CDATA #IMPLIED>
 | |
| <!ATTLIST msg name CDATA #IMPLIED>
 | |
| <!ATTLIST msg desc CDATA #IMPLIED>
 | |
| <!ATTLIST msg meaning CDATA #IMPLIED>
 | |
| <!ATTLIST msg obsolete (obsolete) #IMPLIED>
 | |
| <!ATTLIST msg xml:space (default|preserve) "default">
 | |
| <!ATTLIST msg is_hidden CDATA #IMPLIED>
 | |
| 
 | |
| <!ELEMENT source (#PCDATA)>
 | |
| 
 | |
| <!ELEMENT ph (#PCDATA|ex)*>
 | |
| <!ATTLIST ph name CDATA #REQUIRED>
 | |
| 
 | |
| <!ELEMENT ex (#PCDATA)>
 | |
| ]>
 | |
| <messagebundle>
 | |
|   <msg id="7056919470098446707"><source>file.ts:3</source>translatable element <ph name="START_BOLD_TEXT"><ex><b></ex><b></ph>with placeholders<ph name="CLOSE_BOLD_TEXT"><ex></b></ex></b></ph> <ph name="INTERPOLATION"><ex>{{ interpolation}}</ex>{{ interpolation}}</ph></msg>
 | |
|   <msg id="2981514368455622387"><source>file.ts:4</source>{VAR_PLURAL, plural, =0 {<ph name="START_PARAGRAPH"><ex><p></ex><p></ph>test<ph name="CLOSE_PARAGRAPH"><ex></p></ex></p></ph>} }</msg>
 | |
|   <msg id="7999024498831672133" desc="d" meaning="m"><source>file.ts:5</source>foo</msg>
 | |
|   <msg id="i" desc="d" meaning="m"><source>file.ts:6</source>foo</msg>
 | |
|   <msg id="bar"><source>file.ts:7</source>foo</msg>
 | |
|   <msg id="baz"><source>file.ts:8</source>{VAR_PLURAL, plural, =0 {{VAR_SELECT, select, other {<ph name="START_PARAGRAPH"><ex><p></ex><p></ph>deeply nested<ph name="CLOSE_PARAGRAPH"><ex></p></ex></p></ph>} } } }</msg>
 | |
|   <msg id="6997386649824869937"><source>file.ts:9</source>Test: <ph name="ICU"><ex>{ count, plural, =0 {...} =other {...}}</ex>{ count, plural, =0 {...} =other {...}}</ph></msg>
 | |
|   <msg id="5229984852258993423"><source>file.ts:9</source>{VAR_PLURAL, plural, =0 {{VAR_SELECT, select, other {<ph name="START_PARAGRAPH"><ex><p></ex><p></ph>deeply nested<ph name="CLOSE_PARAGRAPH"><ex></p></ex></p></ph>} } } =other {a lot} }</msg>
 | |
|   <msg id="2340165783990709777"><source>file.ts:10,11</source>multi
 | |
| lines</msg>
 | |
| </messagebundle>
 | |
| `;
 | |
| 
 | |
|     it('should write a valid xmb file', () => {
 | |
|       expect(toXmb(HTML, 'file.ts')).toEqual(XMB);
 | |
|       // the locale is not specified in the xmb file
 | |
|       expect(toXmb(HTML, 'file.ts', 'fr')).toEqual(XMB);
 | |
|     });
 | |
| 
 | |
|     it('should throw when trying to load an xmb file', () => {
 | |
|       expect(() => {
 | |
|         const serializer = new Xmb();
 | |
|         serializer.load(XMB, 'url');
 | |
|       }).toThrowError(/Unsupported/);
 | |
|     });
 | |
|   });
 | |
| }
 | |
| 
 | |
| function toXmb(html: string, url: string, locale: string | null = null): string {
 | |
|   const catalog = new MessageBundle(new HtmlParser, [], {}, locale);
 | |
|   const serializer = new Xmb();
 | |
| 
 | |
|   catalog.updateFromTemplate(html, url, DEFAULT_INTERPOLATION_CONFIG);
 | |
| 
 | |
|   return catalog.write(serializer);
 | |
| }
 |